home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / atmilmid.z / atmilmid
Encoding:
Text File  |  2002-10-03  |  9.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. aaaattttmmmmiiiillllmmmmiiiidddd((((1111MMMM))))                                                      aaaattttmmmmiiiillllmmmmiiiidddd((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      atmilmid -  SNMP agent supporting ATM Forum's ILMI MIBs
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////eeeettttcccc////aaaattttmmmmiiiillllmmmmiiiidddd [[[[ ----dddd debug ] [ ----llll loglevel ] [ ----pppp port ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      aaaattttmmmmiiiillllmmmmiiiidddd is an SNMP agent supporting the ATM Forum's Interim Local
  16.      Management Interface (ILMI) MIBs. It is registered as a subagent with the
  17.      ssssnnnnmmmmppppdddd, so these MIBs can be scanned with any of the browsers used with
  18.      snmpd. aaaattttmmmmiiiillllmmmmiiiidddd listens on a _U_D_P(7P) socket for queries from the main
  19.      SNMP agent (i.e. ssssnnnnmmmmppppdddd). By default, it uses port 23849, however
  20.      alternate ports can be specified with the ----pppp flag.
  21.  
  22.      In addition to fielding queries from the main agent over IP, the aaaattttmmmmiiiillllmmmmiiiidddd
  23.      also exchanges SNMP-encoded ILMI messages with the ATM switch on the
  24.      other side of each User-Network-Interface (UNI) that it manages. The most
  25.      important of the UNI ILMI procedures is the address registration
  26.      procedure at switch or user startup. Without this autoconfiguration
  27.      procedure, the ATM address to be used at each UNI would have to be
  28.      statically configured on both the switch and host.
  29.  
  30.      By default (without use of the ----dddd flag), aaaattttmmmmiiiillllmmmmiiiidddd logs its messages to
  31.      _s_y_s_l_o_g(3B).
  32.  
  33.    OOOOppppttttiiiioooonnnnssss
  34.      aaaattttmmmmiiiillllmmmmiiiidddd accepts the following command line options.
  35.  
  36.      -p _p_o_r_t     This option defines an alternate UDP port to use for
  37.                  servicing queries by the main agent (i.e. ssssnnnnmmmmppppdddd). If this
  38.                  option is used, the port field for this subagent (aaaattttmmmmiiiillllmmmmiiiidddd)
  39.                  in the file /_e_t_c/_s_n_m_p_d._r_e_m_o_t_e._c_o_n_f must be changed to match.
  40.  
  41.      -l _l_o_g_l_e_v_e_l This option controls the level of messages produced by
  42.                  aaaattttmmmmiiiillllmmmmiiiidddd.  The value of _l_o_g_l_e_v_e_l is the text string as used
  43.                  by _s_y_s_l_o_g(3B): _D_E_B_U_G, _I_N_F_O, _N_O_T_I_C_E, _W_A_R_N_I_N_G, _E_R_R, _C_R_I_T,
  44.                  _A_L_E_R_T, and _E_M_E_R_G and can be found in
  45.                  /_u_s_r/_i_n_c_l_u_d_e/_s_y_s/_s_y_s_l_o_g._h.  For example, the _l_o_g_l_e_v_e_l _W_A_R_N_I_N_G
  46.                  would display all warning messages and all messages with a
  47.                  level higher than _W_A_R_N_I_N_G. The default value for _l_o_g_l_e_v_e_l is
  48.                  _E_R_R.
  49.  
  50.      -d _d_e_b_u_g    This option sets the debugging modes of aaaattttmmmmiiiillllmmmmiiiidddd.  This is
  51.                  meant for interactive use only and must not be placed in the
  52.                  atmilmid.options file.  Possible values for _d_e_b_u_g are _d_u_m_p,
  53.                  _i_n_p_u_t, _o_u_t_p_u_t, and _f_o_r_e_g_r_o_u_n_d.  _d_u_m_p will hex dump incoming
  54.                  and outgoing packets; _i_n_p_u_t will display decoded incoming
  55.                  packets; _o_u_t_p_u_t will display decoded outgoing packets; and
  56.                  _f_o_r_e_g_r_o_u_n_d will make the daemon run in the foreground and log
  57.                  messages to the standard output.  The _d_u_m_p, _i_n_p_u_t, and _o_u_t_p_u_t
  58.                  options all imply the _f_o_r_e_g_r_o_u_n_d option.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaattttmmmmiiiillllmmmmiiiidddd((((1111MMMM))))                                                      aaaattttmmmmiiiillllmmmmiiiidddd((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      Stipulating these options in the file /_e_t_c/_c_o_n_f_i_g/_a_t_m_i_l_m_i_d._o_p_t_i_o_n_s will
  75.      cause the options to be used whenever aaaattttmmmmiiiillllmmmmiiiidddd is invoked at boot time
  76.      from the shell script /_e_t_c/_i_n_i_t._d/_a_t_m. WWWWAAAARRRRNNNNIIIINNNNGGGG:::: Do _n_o_t place the -d flag
  77.      in the /_e_t_c/_c_o_n_f_i_g/_a_t_m_i_l_m_i_d._o_p_t_i_o_n_s file as it causes the aaaattttmmmmiiiillllmmmmiiiidddd to run
  78.      in the foreground, blocking everything after it in the boot sequence. The
  79.      -d flags should only be used when debugging a specific problem, when the
  80.      original atmilmid process should be killed, and a new instance started
  81.      with debug output redirected to a disk file. Killing and restarting the
  82.      aaaattttmmmmiiiillllmmmmiiiidddd process will not disrupt any ATM connections in progress, and
  83.      none of the other ATM software needs to be reset or re-initialized. The
  84.      only noticeable disruption is that there may be a temporary inability to
  85.      initiate new connections during the time when there is no aaaattttmmmmiiiillllmmmmiiiidddd
  86.      running.
  87.  
  88.      The aaaattttmmmmiiiillllmmmmiiiidddd uses the file /_e_t_c/_s_n_m_p_d._a_u_t_h to authorize queries over the
  89.      IP UDP port (see snmpd(1M) for more details). ILMI messages received from
  90.      switch(es) over the ATM port(s) are valid if they use community _I_L_M_I, as
  91.      specified by the ATM Forum UNI.
  92.  
  93.      TTTThhhheeee CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn FFFFiiiilllleeee
  94.  
  95.      All configuration for the aaaattttmmmmiiiillllmmmmiiiidddd is defined in the file
  96.      /_v_a_r/_a_t_m/_a_t_m_i_l_m_i_d._c_o_n_f.
  97.  
  98.      The ATM Forum ILMI defines the concept of a unique _P_o_r_t _I_n_t_e_r_f_a_c_e _I_n_d_e_x
  99.      associated with each ATM port on the system. These are defined in the
  100.      file /_v_a_r/_a_t_m/_a_t_m_i_l_m_i_d._c_o_n_f using the _A_T_M_P_O_R_T keyword. Read the comments
  101.      section at the start of the file for an explanation of the syntax used.
  102.      This file must be edited when additional ATM cards are installed (or
  103.      removed) to define ports to be managed by the aaaattttmmmmiiiillllmmmmiiiidddd.  The ATM Forum
  104.      has defined VPI 0, VCI 16 as the default VPI/VCI pair to be used for ILMI
  105.      messages, so if your switch is configured to use a non-standard VPI/VCI,
  106.      edit this file to specify the VPI and VCI to be used.
  107.  
  108.      If the IRIX ATM port is attached to a switch that does not support ILMI
  109.      address registration, then an ATM address has to be assigned to that
  110.      port, and that address has to be configured both on this system, as well
  111.      as in the switch's routing table. To configure an ATM address for a port,
  112.      use the ATMADDRESS keyword to define the address in the configuration
  113.      file /_v_a_r/_a_t_m/_a_t_m_i_l_m_i_d._c_o_n_f. The syntax and address formats are described
  114.      in the comments in the ATMADDRESS section in that file. This address does
  115.      not have to be defined if the port is attached to a switch supporting
  116.      ILMI address registration.
  117.  
  118. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  119.      When running in (the default) daemon mode, error messages are logged in
  120.      /usr/adm/SYSLOG. If the aaaattttmmmmiiiillllmmmmiiiidddd encounters any I/O errors on any ATM
  121.      port, it will shut down operations on that port, but keep running
  122.      otherwise. This behaviour ensures that there are no disruptions in
  123.      service on other ATM ports in the system. The following error message
  124.      will be logged in /usr/adm/SYSLOG:
  125.           "Terminating operation on /hw/atm/#, send SIGHUP signal to resume
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaattttmmmmiiiillllmmmmiiiidddd((((1111MMMM))))                                                      aaaattttmmmmiiiillllmmmmiiiidddd((((1111MMMM))))
  137.  
  138.  
  139.  
  140.           when board is operational"
  141.      When you send the SIGHUP signal ("killall -HUP atmilmid") it will cause
  142.      the aaaattttmmmmiiiillllmmmmiiiidddd to probe every interface which it has marked as
  143.      unoperational. If the error conditions are no longer present, the
  144.      aaaattttmmmmiiiillllmmmmiiiidddd will resume operations on that interface. If you use atmconfig
  145.      to reset a board, you must send a SIGHUP to the aaaattttmmmmiiiillllmmmmiiiidddd after you have
  146.      brought the board back up.
  147.  
  148. FFFFIIIILLLLEEEESSSS
  149.      /usr/etc/atmilmid
  150.      /etc/config/atmilmid.options
  151.      /etc/init.d/atm
  152.      /etc/snmpd.data
  153.      /etc/snmpd.auth
  154.      /etc/snmpd.remote.conf
  155.      /usr/lib/netvis/mibs/atmf_ilmi.mib
  156.      /var/atm/atmilmid.conf
  157.  
  158. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  159.      atm(7M), if_atm(7M), atmsigd(1M), atmconfig(1M), atmstat(1M),
  160.      ifatmconfig(1M), snmpd(1M)
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.